home *** CD-ROM | disk | FTP | other *** search
/ Sunday Savers: Singing Fun! / Sunday Savers: Singing Fun!.iso / mac / Xtras / Buddy API 1.6 / Buddy API Docs.swf / texts / 1668.txt < prev    next >
Encoding:
Text File  |  2004-08-31  |  2.1 KB  |  97 lines
  1. 168
  2. --- RECORDSEPARATOR ---
  3.  
  4. --- RECORDSEPARATOR ---
  5. ActiveWindow 
  6. --- RECORDSEPARATOR ---
  7. Platform:
  8. --- RECORDSEPARATOR ---
  9.  
  10. --- RECORDSEPARATOR ---
  11. Windows and Macintosh
  12. --- RECORDSEPARATOR ---
  13.  
  14. --- RECORDSEPARATOR ---
  15. Description:
  16. --- RECORDSEPARATOR ---
  17.  
  18. --- RECORDSEPARATOR ---
  19. baActiveWindow returns the handle of the currently active window.
  20. --- RECORDSEPARATOR ---
  21.  
  22. --- RECORDSEPARATOR ---
  23. Usage:
  24. --- RECORDSEPARATOR ---
  25.  
  26. --- RECORDSEPARATOR ---
  27. Result = baActiveWindow()
  28. --- RECORDSEPARATOR ---
  29.  
  30. --- RECORDSEPARATOR ---
  31. Arguments:
  32. --- RECORDSEPARATOR ---
  33.  
  34. --- RECORDSEPARATOR ---
  35. Void.
  36. --- RECORDSEPARATOR ---
  37.  
  38. --- RECORDSEPARATOR ---
  39. Returns:
  40. --- RECORDSEPARATOR ---
  41.  
  42. --- RECORDSEPARATOR ---
  43. Integer. 
  44. --- RECORDSEPARATOR ---
  45. Returns the handle of the active window.
  46. --- RECORDSEPARATOR ---
  47.  
  48. --- RECORDSEPARATOR ---
  49. Examples:
  50. --- RECORDSEPARATOR ---
  51.  
  52. --- RECORDSEPARATOR ---
  53. Director: 
  54. --- RECORDSEPARATOR ---
  55. set WinHandle = baActiveWindow() 
  56. --- RECORDSEPARATOR ---
  57. Authorware: 
  58. --- RECORDSEPARATOR ---
  59. WinHandle := baActiveWindow()
  60. --- RECORDSEPARATOR ---
  61.  
  62. --- RECORDSEPARATOR ---
  63. Notes:
  64. --- RECORDSEPARATOR ---
  65.  
  66. --- RECORDSEPARATOR ---
  67. On
  68. --- RECORDSEPARATOR ---
  69.  Windows
  70. --- RECORDSEPARATOR ---
  71. , under some conditions, this function can return 0. This would 
  72. --- RECORDSEPARATOR ---
  73. typically happen during the time an application starts up - the app may have 
  74. --- RECORDSEPARATOR ---
  75. control, but not yet opened its main window. Do not use a loop such as this: 
  76. --- RECORDSEPARATOR ---
  77. set wnd = 0 
  78. --- RECORDSEPARATOR ---
  79. baRunProgram( "other.exe" , "normal" , false ) 
  80. --- RECORDSEPARATOR ---
  81. repeat while wnd <> baWinHandle() 
  82. --- RECORDSEPARATOR ---
  83. set wnd = baActiveWindow() 
  84. --- RECORDSEPARATOR ---
  85. --
  86. --- RECORDSEPARATOR ---
  87.  ActiveWindow could return 0
  88. --- RECORDSEPARATOR ---
  89.  
  90. --- RECORDSEPARATOR ---
  91. end repeat 
  92. --- RECORDSEPARATOR ---
  93. In the case above, it is possible that wnd will equal 0, not the window handle of the 
  94. --- RECORDSEPARATOR ---
  95. new application. A better way to achieve this is to use the baNextActiveWindow 
  96. --- RECORDSEPARATOR ---
  97. function.